home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / ckzp101.arc / CHECKZIP.DOC < prev    next >
Text File  |  1991-01-26  |  9KB  |  177 lines
  1. ============================================================================
  2. CHECKZIP.DOC :  Lewis Huang, Singapore   : CHECKZIP v1.01   9th January 1991
  3. ============================================================================
  4.  
  5. What is CheckZip and what does it do?
  6. -------------------------------------
  7. CheckZip is a shell for extracting, virus testing, and re-archiving to/from
  8. any archive format. CheckZip will examine entire subdirectory, test/extract
  9. all archives matching the file extension mask (ie ZIP), including nested
  10. archives, and recursively  scan all subdirectories for viruses. It can then
  11. optionally re-archive the files to any archive format.
  12.  
  13. The beauty of CheckZip is it's flexibility. This  flexibility is built into
  14. CheckZip by using an configuration file for specifying the file extension
  15. mask (ie ZIP), the name of the extractor (ie PKUNZIP), the name of the virus
  16. scanner (ie SCAN), the name of the archiver (ie PKZIP). For each program you
  17. are able to specify the parameters you want. CheckZip will also optionally
  18. shell to a batch file before re-archiving takes place to perform other
  19. functions (ie add/ delete/sort files).
  20.  
  21. In addition to all this CheckZip is intelligent enough not to check archives
  22. that it has already tested by it's ability to timestamp archives. It will
  23. also move corrupted or virus infected archives to a separate subdirectory.
  24.  
  25.  
  26. The files that come in this package:
  27. ------------------------------------
  28. CHECKZIP.EXE - The program
  29. CHECKZIP.CFG - The sample configuration file
  30. CHECKZIP.DOC - This documentation
  31. HINTS.BBS    - Hints for bbs SysOps
  32. PCB-SiG.COM  - The bbs advertisement
  33.  
  34.  
  35. How to configure CheckZip:
  36. --------------------------
  37. The sample CFG file looks like this:-
  38.  
  39. ZIP                         ; file extension mask
  40. C:\ZIP\PKUNZIP.EXE          ; full path & program name of extraction program
  41. -d *.exe *.com *.ovl        ; extraction program switches
  42. C:\ZIP\PKZIP.EXE            ; full path & program name of archiver program
  43. -r -p -o                    ; archiver program switches
  44. C:\ZIP\SCAN.EXE             ; full path & program name of virus scanner
  45. /nomem                      ; virus scanner switches
  46. C:\ZIP\CKZIP.BAT            ; full path & batch file name
  47. C:\ZIP\CHECKZIP.LOG         ; full path & name name of log file
  48. C:\BADFILES                 ; bad files directory
  49. hh:mm:ss                    ; time stamp
  50.  
  51.  
  52. Line 1 : This tells CheckZip which archive format to extract. The filename
  53.          extension mask (ie ZIP ARC LZH etc) must be compatible with the
  54.          archive extractor used in Line 2. Only 1 extension mask permitted.
  55.  
  56. Line 2 : This tells CheckZip which program to use for extracting archives
  57.          and where to find it. The full Drive:\Path\Filename.Ext must be used.
  58.  
  59. Line 3 : This tells CheckZip which switches to use for the archive extractor
  60.          used in Line 2. Only the extractor programs internal optional
  61.          switches should be included here. This line MUST NOT include the
  62.          subdirectory or file name to process.
  63.  
  64.          Wildcard file selection may be used so that only those files tested
  65.          by the virus scanner are extracted. Wildcards will speed up the
  66.          extraction process but WARNING: Do NOT use the rezipping function,
  67.          as only those files extracted will be rezipped. If Wildcard file
  68.          extraction is used Lines 4 & 5 MUST be left blank.
  69.  
  70. Line 4 : This tells CheckZip which program to use for archiving the files
  71.          and where to find it. The full Drive:\Path\Filename.Ext must be used.
  72.          The re-archiving of files is optional. If you do not wish to perform
  73.          any re-archiving, leave this line and Line 5 blank.
  74.  
  75. Line 5 : This tells CheckZip which switches to use for the archive program
  76.          used in Line 4. Only the archiver programs internal optional switches
  77.          should be included here. This line MUST NOT include the subdirectory
  78.          or file name to process.
  79.  
  80. Line 6 : This tells CheckZip which program to use for virus scanning and where
  81.          to find it. The full Drive:\Path\Filename.Ext must be used. The virus
  82.          scanning is optional. If you do not wish to perform any virus scan,
  83.          leave this line and Line 7 blank.
  84.  
  85. Line 7 : This tells CheckZip which switches to use for the virus scanner. Only
  86.          virus scanner's internal optional switches should be included here.
  87.          This line MUST NOT include the drive, subdirectory or file name to
  88.          process.
  89.  
  90. Line 8 : This tells CheckZip the name of the batch file to process before re-
  91.          archiving the file under testing. The full Drive:\Path\Filename.Ext
  92.          must be used. The batch file is optional. If you do not wish to shell
  93.          to this batch file, leave this line blank.
  94.  
  95.          Checkzip will pass all it's command line parameters to the batch file
  96.          that are entered as parameters to CheckZip (see below).
  97.  
  98. Line 9 : This tells CheckZip the name of the LOG file and where to find it.
  99.          The full Drive:\Path\Filename.Ext must be used. The LOG file will
  100.          record the time, date, filename and test results. The LOG file is
  101.          optional. If you do not wish to have a record of CheckZip's activity
  102.          leave this line blank.
  103.  
  104. Line 10: This tells CheckZip where to move corrupted or infected archives.
  105.          This must be a valid subdirectory. CheckZip WILL NOT create it. This
  106.          moving of bad files is optional. If you do not want to examine bad
  107.          archives, leave this line blank and the bad files will be deleted.
  108.  
  109. Line 11: This tells CheckZip the timestamp to place on tested archives. The
  110.          timestamp is optional. If you do not wish to mark the file as having
  111.          passed the CheckZip tests, leave this line blank. Some examples of
  112.          the syntax are:-
  113.  
  114.                         08:08:04 = 8am 8 minutes 4 seconds
  115.                         :16:10   = leave hours alone and change mins/secs to
  116.                                    16 minutes 10 seconds
  117.                         ::14     = leave hours/mins alone and change secs to
  118.                                    14 seconds
  119.  
  120.          The last example (::ss) is particularly useful because the seconds
  121.          are not displayed by dos and therefore provide a 'hidden' record of
  122.          the file having passed the CheckZip tests. Please note that there
  123.          is a Dos limitation that seconds must be an EVEN number between 00
  124.          and 60 seconds.
  125.  
  126.  
  127. CheckZip in Use:
  128. ----------------
  129. CheckZip requires DOS 3.x and above to operate. You will also need a virus
  130. scanning program (ie McAfee's VIRUSCAN) and archive utilities (ie PKWare's
  131. PKUNZIP/PKZIP)
  132.  
  133. To run CheckZip, place CHECKZIP.EXE & CHECKZIP.CFG in the same subdirectory
  134. located in your dos PATH statement and type at the dos prompt
  135.  
  136.                 CHECKZIP Drive:\Path\Subdir
  137.  
  138. where the Drive:\Path\Subdir is the name of the subdirectory in which the
  139. archives to test are residing. The Drive: is optional. CheckZip will use
  140. the default drive if none is specified. The \Path\Subdir is NOT optional
  141. and MUST always be present as the first parameter after CHECKZIP.
  142.  
  143. You may include additional parameters after the Drive:\Path\Subdir. These
  144. are NOT used by CheckZip but are passed as parameters directly to the batch
  145. file. All the CheckZip parameters are passed to the batch file in the same
  146. order as they appear when running CHECKZIP, including the Drive:\Path\Subdir.
  147. This is useful when running CheckZip from a batch file (ie ProDoor PROUTEST.
  148. BAT or PCBoard's PCBTEST.BAT) which has parameters you wish to pass on to
  149. your batch file (ie Drive:\path\filename or comm port).
  150.  
  151. Testing of files should always be performed in a subdirectory.
  152.  
  153. The CHECKZIP.CFG file MUST reside in the same subdirectory as CHECKZIP.EXE
  154.  
  155.  
  156. Copyright & Registration
  157. ------------------------
  158. Phew! There is none! The name CheckZip, the program, the configuration file
  159. structures and this documentation are all hereby donated to the Public Domain.
  160. All I ask is you give PCB-SiG BBS a call on Singapore (65) 734 9519 and record
  161. your gratitude to Lewis Huang.
  162.  
  163. Disclaimer
  164. ----------
  165. CheckZip is offered on an 'AS IS' basis and the author assumes no responsib-
  166. ility for any damage to your machine or loss of data incurred while using
  167. CheckZip and disclaims all warranties, express or implied, as to the fitness
  168. for any particular purpose.
  169.  
  170. ============================================================================
  171.  
  172. Have fun.... Stewart                                          PCB-SiG BBS
  173.                                                              (65) 734 9519
  174.  
  175.                                                             9th January 1991
  176.  
  177.